.. _cmmCfgGetInOutRatio: 

cmmCfgGetInOutRatio
=====================
---------------------


SYNOPSYS
`````````

.. code-block:: none

     VT_I4 cmmCfgGetInOutRatio
     ([in] VT_I4 Axis, [out] VT_PR8 Ratio
     )


DESCRIPTION
`````````````

- Feedback 펄스와 Command 펄스의 분해능 비율(Resolution ratio)을 설정합니다. Feedback 펄스의 분해능이란 엔코더의 1회전 시에 발생되는 펄스 수를 의미합니다.
  Command 펄스의 분해능이란 모터를 1회전시키기 위해 필요한 Command 펄스 수를 의미합니다.


PARAMETER
```````````

- Axis: 축번호. 축번호는 상수값으로 [cmX1] 부터 0 번째 축을 기준 축으로 임의의 축을 설정할 수 있습니다.

\

- Ratio : Ratio : cmmCfgGetInOutRatio 함수의 인자이며, Feedback 펄스와 Command 펄스의 분해능 비를 반환합니다.


                                Ratio = (Feedback 펄스 분해능)/(Command 펄스의 분해능)



RETURN VALUE
`````````````

- cmmCfgSetInOutRatio() 및 cmmCfgGetInOutRatio() 함수의 반환값

+--------------+----------------+
| Value        | Meaning        |
+==============+================+
| 음수         | 수행 실패      |
+--------------+----------------+
| cmERR_NONE   | 수행 성공      |
+--------------+----------------+


seealso 
`````````

□ In/Out Ratio 는 Actual(Feedback) position 또는 Actual speed 를 논리 단위로 읽을 때 적용됩니다. 논리적 단위 거리나 단위 속도는 Command 펄스기준으로 설정되므로 Command 펄스와 Feedback 펄스의 분해능이 서로 다르다면 Actual position 이나 Actual speed 의 논리값 계산이 잘못되게 됩니다.

\

□ In/Out Ratio 는 cmmStGetPosition() 함수와 cmmStGetSpeed() 함수에서 카운터를 cmCNT_FEED 으로 설정한 경우에만 영향을 미칩니다.



Example
`````````

- cmmCfgSetInOutRatio를 참조하세요.


.. seealso:: :ref:`cmmCfgSetInOutRatio`